home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 36 / Amiga Format CD36 (1999-01-22)(Future Publishing)(GB)[!][issue 1999-02].iso / -in_the_mag- / under_the_bonnet / control / logimouse1053 / logimouse.man < prev    next >
Text File  |  1998-12-03  |  9KB  |  238 lines
  1. LogiMouse                           Manual                            LogiMouse
  2.  
  3.    NAME
  4.  
  5.       LogiMouse - Mouse Driver for LogiTech serial mice
  6.                    (eg TrackMan trackball)
  7.  
  8.    SYNOPSIS
  9.       
  10.       LogiMouse      [-d <serial.device>]
  11.                      [-u <unit>]
  12.                      [-m <qualifier>|<Button>]
  13.                      [-r <qualifier>|<Button>]
  14.                      [-l <qualifier>|<Button>]
  15.                      [-3]
  16.                      [-q]
  17.                      [-b <Baud rate>]
  18.                      [-s <Stop bits>]
  19.                      [-w <Read/Write len>]
  20.   
  21.    DESCRIPTION
  22.  
  23.       A few months ago i bought a LogiTech Trackman TrackBall (which if you
  24.       haven't seen one is the most wonderfully shaped trackball known to man
  25.       (well to me..) your hand just flops over the thing... soo cumfy!), as
  26.       i have a serial card, spare serial ports where not a problem.
  27.       
  28.       I chearfully grabbed sermouse from Aminet, only to find out that my
  29.       TrackMan doesn't actually use either of the protocols sermouse does..
  30.  
  31.       So i wrote my own driver.
  32.  
  33.       Also i wanted to swap the middle button and the right button so that
  34.       got incorperated.
  35.  
  36.       To install the thing just put a line in your user-startup like
  37.       
  38.       sys:bin/boot/LogiMouse -u2 -mRSH
  39.  
  40.       You can alter the settings whist the driver is running, just run the 
  41.       driver again with the new settings and it'll send the info to the first
  42.       instance of the driver and exit (only one instance of the driver can be
  43.       running)                     
  44.       
  45.       Note: You can also send LogiMouse a CTRL-C (break) to quit.
  46.  
  47.    OPTIONS
  48.  
  49.       -d <serial.device>         (defaults to serial.device)
  50.       -u <unit>                  (defaults to 0)
  51.       -q                                 quit
  52.       -m <qualifier>|<Button>     middle mouse buttion = qual. (ie shift, alt etc)/button
  53.       -r    <qualifier>|<Button>     right mouse buttion = qual. (ie shift, alt etc)/button
  54.       -l <qualifier>|<Button>     lift mouse buttion = qual. (ie shift, alt etc)/button
  55.       -3                                    Reset mouse to std 3 buttons
  56.       -b <Baud rate>             (defaults to 1200 (correct setting))
  57.       -s <StopBits>              (defaults to 1 (correct setting))
  58.       -w <Read/Write len>        (defaults to 7 (correct setting))
  59.  
  60.    QUALIFIERS
  61.  
  62.       R                          Right Button
  63.       M                          Middle Button
  64.       L                          Left Button
  65.       
  66.       RSHIFT   (RS)              Right Shift key
  67.       LSHIFT   (LS)              Left Shift key
  68.       RCOMMAND (RC)              Right Amiga Key
  69.       LCOMMAND (LC)              Left Amiga Key
  70.       RALT     (RA)              Right Amiga Key
  71.       LALT     (LA)              Left Amiga Key
  72.       CONTROL  (CT)              Control Ket      
  73.  
  74.    EXAMPLE
  75.  
  76.       sys:bin/boot/LogiMouse >NIL: -u2 -mRSH
  77.        
  78.        - uses unit 2 of the serial.device, middle button is mapped 
  79.          to right shift (only have to specify enough of the qualifier to
  80.          differentiate between it and other qualifiers)
  81.  
  82.       LogiMouse >NIL: -lR -rL -mRC
  83.  
  84.        - use serial.device, unit 0, swap left and right mouse buttons, map
  85.          middle mouse button to right control key
  86.  
  87.       LogiMouse -q
  88.  
  89.        - Quit driver  
  90.  
  91.    ERRORS
  92.  
  93.       If there are not enough resources for LogiMouse to run it will exit
  94.       (this is not very likely - it doesn't exactly use much mem.)
  95.  
  96.    WARNING
  97.    
  98.       Remember: If the mouse driver is not running you cannot use your 
  99.       LogiTech mouse, for example the early startup screen, or canceling
  100.       GURUs that have reset your Ami.
  101.  
  102.    BUGS/PROBLEMS
  103.  
  104.       DragIT Commodity refuses to work at all with my driver.
  105.  
  106.       (in 4 months of constant use this is the only problem i have found 
  107.       with the 'normal' functions of the mouse (ie 3 buttons))
  108.  
  109.       The Qualifiers (discluding swapping buttons and having shift as a
  110.       button) should be considered as a bonus.. ie wether they'll work with
  111.       a program depends on how the program reads the information from the
  112.       system.          
  113.       
  114.       NB They're only qualifiers - not keypresses!
  115.  
  116.       (personally i'm just using my mouse as a standard 3 button mouse at the 
  117.       moment, using yak by Gaël Marziou and Philippe Bastiani to use the 
  118.       middle button as shift and also as window to front/back)
  119.  
  120.       Feel free to email me with bug-reports/suggestions etc (i may even
  121.       act upon them)
  122.  
  123.       
  124.       Doesn't work with your LogiTech serial mouse?
  125.  
  126.        NB LogiMouse requires a serial port/device that can be set to 7N1 
  127.        (7 read/write bits, no parity, 1 stopbit). (this is not as simple as it
  128.           sounds.. 7N1 is completely alien to the Amiga.. The internal serial port
  129.           (on my 4000 anyway) does not support it. Note again that some serial 
  130.        drivers will say they've set it when they actually haven't.. <ARGG>). 
  131.        
  132.        If LogiMouse just exits then there are 3 possibilities - it cannot 
  133.        allocate necessary resources, the serial port is in use, or the serial
  134.        port does not support the settings LogiMouse wants.
  135.        
  136.        NB some serial.drivers (eg the one from C=) lie - they say they've set
  137.        the serial.port ok when in fact they haven't (this will cause the mouse
  138.        to go absolutly mental and jump all over the screen doing all sorts
  139.        of things on the way..). 
  140.        
  141.        If anyone knows a way to get round this (somehow converting 8N1 data
  142.        to 7N1???) please get in touch with me.  
  143.  
  144.  
  145.    SPECIAL REQUIREMENTS
  146.  
  147.    Needs OS 2.04 or higher.
  148.    Spare serial port that supports 7N1 (such as the C= A2232 serial card). 
  149.    (NB the internal port doesn't support 7N1 (well mine doesn't)).
  150.    
  151.    LogiTech Mouse that uses the 'MouseMan' protocol, eg the TrackMan trackball
  152.  
  153.    (if you have a LogiTech Mouse that won't work with sermouse/optmouse or any
  154.    of the other serial drivers around, then it prob. uses this protocol 
  155.    (maybe.. ;-) ))     
  156.              
  157.    AUTHOR
  158.  
  159.       Simon Richardson
  160.       simon@albert.demon.co.uk
  161.  
  162.    COPYRIGHT
  163.  
  164.       Simon Richardson 1994 - 1995.
  165.  
  166.    PRICE
  167.  
  168.       LogiMouse is emailware (if you like it let me know)
  169.  
  170.    DISTRIBUTABILITY
  171.  
  172.       Freely Distributable, (c) 1994-95 Simon Richardon
  173.  
  174.    DISCLAMER
  175.  
  176.       If LogiMouse steals your dog, has an affair with your wife, 
  177.       implodes your hard disk etc etc then its a real shame.. but then
  178.       its free init??                                   
  179.       
  180.       LogiMouse has been running on my Amiga for over 4 months with no 
  181.          problems (so i think its fairly stable.. ;-) )
  182.  
  183.       LogiMouse definitly works with my mouse.. (LogiTech TrackMan 
  184.       (Series 9 if mem. serves)) No guarantees it'll work with yours 
  185.       (but if it doesn't and your mouse is a LogiTech mouse - tell me 
  186.       (and if you send me some output from SerDiag i might even get it 
  187.       to work for you)).  
  188.       
  189.       Also if it don't work read the 'Doesn't work with your LogiTech 
  190.       serial mouse?' bit in BUGS/PROBLEMS above.
  191.       
  192.       If you like it, use it.. If you hate it delete it.
  193.         
  194.    HISTORY 
  195.    
  196.       1.03  08/02/95    First Aminet release.
  197.  
  198.       1.04  29/03/95    Got some email from a chap with a MouseMan mouse..
  199.                         which doesn't work with this driver. 
  200.                         (Humm didn't i say LogiMouse uses the 'MouseMan'
  201.                         protocol? (it does honest..))
  202.  
  203.                         Added -b <baud>, -s <StopBits>, -w <Read/Write len>
  204.                         to (hopefully) help LogiMouse work with the MouseMan
  205.  
  206.       1.05              Bugfix: Now skips mouse handshake MSG.
  207.       
  208.       1.051    05/04/95        LogiMouse now exits if the serial.device used tells
  209.                               it that it cannot set the hardware to 7N1 (some
  210.                                serial.devices lie of course.. )
  211.  
  212.         1.052    17/05/95        BugFix: Middle mouse button no longer pressed on startup
  213.                                 humm didn't i already fix this ? ;-)
  214.                                 
  215.                                Switched off SC's optimisation (funny feeling its occasionally
  216.                                causing LogiMouse to loose signals on some machines.. very 
  217.                                strange, i hope this helps (i haven't had this problem but
  218.                                apparently its there.. ???)
  219.         
  220.         1.053    17/05/95        Tided code up some (removed some unness. bits), optmised
  221.                                 code in the process.
  222.                                 
  223.                                 Added '030 version to the archive                                
  224.  
  225.    THANKS
  226.  
  227.       A.J.terSteege, Emilio Desalvo, Erik Hill for telling me that LogiMouse
  228.       doesn't work with their mice (and either sending me output
  229.       or trying to from SerDiag).. Enabling me to work out (with the help
  230.       of several serial.devices, ports and Amigas) that setting 7N1 on an
  231.       Amiga is a bitch.
  232.       
  233.       Sorry i cannot solve this (but if anyone can.. mail me!).   
  234.       
  235.       Andreas Baum for finnally getting me to fix the middle mouse button
  236.       thing again and everyone else who's written with cheerful msgs
  237.       'Hi, like your driver, but it doesn't work...' <GRR> ;-)
  238.